package cn.cyh.queue_service.config;

import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * Swagger配置类
 */
@Configuration
public class SwaggerConfig {

    /**
     * 创建API基本信息
     */
    @Bean
    public OpenAPI queueServiceOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("人脸识别排队叫号系统API文档")
                        .description("基于人脸识别的排队叫号系统API接口文档<br><br>" +
                                "<h3>WebSocket端点</h3>" +
                                "<ul>" +
                                "<li><strong>叫号大屏:</strong> <code>ws://[服务器地址]/ws/call-screen</code></li>" +
                                "<li><strong>队列状态:</strong> <code>ws://[服务器地址]/ws/queue-status</code></li>" +
                                "</ul>" +
                                "<p>WebSocket接口支持实时推送队列状态和叫号信息，详情请参考WebSocket接口文档</p>")
                        .version("v1.0.0")
                        .contact(new Contact()
                                .name("开发者")
                                .email("developer@example.com")
                                .url("https://example.com"))
                        .license(new License()
                                .name("MIT License")
                                .url("https://opensource.org/licenses/MIT")))
                .externalDocs(new ExternalDocumentation()
                        .description("系统设计文档")
                        .url("https://example.com/docs"))
                // 配置JWT鉴权
                .addSecurityItem(new SecurityRequirement().addList("JWT"))
                .components(new Components()
                        .addSecuritySchemes("JWT", new SecurityScheme()
                                .type(SecurityScheme.Type.HTTP)
                                .scheme("bearer")
                                .bearerFormat("JWT")
                                .in(SecurityScheme.In.HEADER)
                                .name("Authorization")));
    }

    /**
     * 所有接口 - 在一个页面上展示所有接口
     * 不再进行分组，所有接口统一展示在一个页面
     */
    @Bean
    public GroupedOpenApi allApi() {
        return GroupedOpenApi.builder()
                .group("全部接口")
                .pathsToMatch("/**")
                .build();
    }

    /**
     * WebSocket相关接口
     */
    @Bean
    public GroupedOpenApi webSocketApi() {
        return GroupedOpenApi.builder()
                .group("WebSocket接口")
                .pathsToMatch("/api/websocket/**")
                .build();
    }
} 